RmveResource

Discard a resource from the current file

#include <Resources.h> Resource Manager

void RmveResource(rHandle );

Handle rHandle ; handle to a resource in the current file

Given a handle in the current resource file, this removes it from the

resource map and tags the file for update. It does not release the memory

used to hold the handle's data.

rHandle is a resource handle from the current resource file. It is a value

Returns: none (if rHandle is not from the current resource file or if the

resource is protected, ResError returns rmvResFailed).

Notes: RmveResource is normally used only by resource-management utilities

such as ResEdit. Applications typically want to retain their resources.

RmveResource tags the file for update, so when the file is closed or

updated, or when the application program terminates, the specified

resource will be eliminated from the file.

Use DisposHandle to free the memory occupied by the handle's data.

Until you do so, the handle remains valid (though not for

Resource Manager operations) and can be accessed like any other data

handle.

Use DetachResource for the more common operation of retaining the data

of one resource before dismissing the rest of a resource file.

Referenced by (12):